home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Vk / VkProgram.z / VkProgram
Encoding:
Text File  |  2002-10-03  |  7.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4. VVVVkkkkPPPPrrrrooooggggrrrraaaammmm((((3333xxxx))))                                                    VVVVkkkkPPPPrrrrooooggggrrrraaaammmm((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      VkProgram - Object-oriented interface to subprogram execution
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      VkCallbackObject :
  13.  
  14. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  15.      #include <Vk/VkProgram.h>
  16.  
  17. PPPPUUUUBBBBLLLLIIIICCCC PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLL SSSSUUUUMMMMMMMMAAAARRRRYYYY
  18.    CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr////DDDDeeeessssttttrrrruuuuccccttttoooorrrr
  19.            VkProgram(const char* cmd, int killChildOnExit = 1);
  20.            virtual void ~VkProgram(void);
  21.  
  22.  
  23.    CCCCoooonnnnttttrrrroooollll FFFFuuuunnnnccccttttiiiioooonnnnssss
  24.            virtual VkSubProcess run(void);
  25.  
  26.  
  27.    SSSSeeeettttuuuupppp FFFFuuuunnnnccccttttiiiioooonnnnssss
  28.            void redirectIn(int do_redirect);
  29.  
  30.  
  31. PPPPRRRROOOOTTTTEEEECCCCTTTTEEEEDDDD PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLL SSSSUUUUMMMMMMMMAAAARRRRYYYY
  32.    PPPPrrrrooootttteeeecccctttteeeedddd DDDDaaaattttaaaa MMMMeeeemmmmbbbbeeeerrrrssss
  33.            char* _cmd;
  34.            const int _killChildOnExit;
  35.            int _redirectIn;
  36.  
  37.  
  38. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  39.           The VkProgram class is an object-oriented interface to fork/exec.
  40.           It spawns a program and passes the output back to the application.
  41.  
  42.  
  43.  
  44. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  45.    VVVVkkkkPPPPrrrrooooggggrrrraaaammmm(((())))
  46.            VkProgram(const char* cmd,
  47.                      int killChildOnExit = 1);
  48.            virtual void ~VkProgram(void);
  49.  
  50.  
  51.           Sets up the VkProgram object.  The first argument specifies a
  52.           command to execute when the run() method is called.  The second
  53.           argument indicates that the running child, if any, should be killed
  54.           whenever this process exits.
  55.  
  56.    rrrruuuunnnn(((())))
  57.           virtual VkSubProcess run(void);
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VVVVkkkkPPPPrrrrooooggggrrrraaaammmm((((3333xxxx))))                                                    VVVVkkkkPPPPrrrrooooggggrrrraaaammmm((((3333xxxx))))
  71.  
  72.  
  73.  
  74.           Forks and execs a child process, running the command specified in
  75.           the constructor.  Returns the VkSubProcess object created as a
  76.           result.
  77.  
  78.    rrrreeeeddddiiiirrrreeeeccccttttIIIInnnn(((())))
  79.           void redirectIn(int do_redirect);
  80.  
  81.  
  82.           If the argument is non-zero, indicates that an input pipe should be
  83.           setup when the child process is created, giving the application the
  84.           ability to send input to the process.
  85.  
  86. DDDDAAAATTTTAAAA MMMMEEEEMMMMBBBBEEEERRRR DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  87.    ____ccccmmmmdddd
  88.           char* _cmd;
  89.  
  90.  
  91.           The command to be executed.
  92.  
  93.    ____kkkkiiiillllllllCCCChhhhiiiillllddddOOOOnnnnEEEExxxxiiiitttt
  94.           const int _killChildOnExit;
  95.  
  96.  
  97.           Whether to set the child process options so that it terminates
  98.           whenever the parent process terminates.
  99.  
  100.    ____rrrreeeeddddiiiirrrreeeeccccttttIIIInnnn
  101.           int _redirectIn;
  102.  
  103.  
  104.           Whether to setup an input pipe.
  105.  
  106.    eeeexxxxiiiittttCCCCaaaallllllllbbbbaaaacccckkkk
  107.           static const const char* exitCallback;
  108.  
  109.  
  110.           This callback is called when the child process exits. The callData
  111.           is an integer (cast to type void *) that reports the exit status.
  112.           This callback is passed on to an instance of VkSubProcess, so the
  113.           VkCallbackObject passed as the first argument is actually an
  114.           instance of VkSubProcess.
  115.  
  116.    ssssttttddddoooouuuuttttCCCCaaaallllllllbbbbaaaacccckkkk
  117.           static const const char* stdoutCallback;
  118.  
  119.  
  120.           This callback is called when the child process has output directed
  121.           to stdout. The VkCallbackObject pointer passed as the first argument
  122.           is a VkInput object, because this callback is passed down a chain of
  123.           objects that ultimately ends with a VkInput object that handled
  124.           input from stdout.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. VVVVkkkkPPPPrrrrooooggggrrrraaaammmm((((3333xxxx))))                                                    VVVVkkkkPPPPrrrrooooggggrrrraaaammmm((((3333xxxx))))
  137.  
  138.  
  139.  
  140.    ssssttttddddeeeerrrrrrrrCCCCaaaallllllllbbbbaaaacccckkkk
  141.           static const const char* stderrCallback;
  142.  
  143.  
  144.           This callback is called when the child process has output directed
  145.           to stderr. The VkCallbackObject pointer passed as the first argument
  146.           is a VkInput object, because this callback is passed down a chain of
  147.           objects that ultimately ends with a VkInput object that handled
  148.           input from stderr.
  149.  
  150. IIIINNNNHHHHEEEERRRRIIIITTTTEEEEDDDD MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  151.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkCCCCaaaallllllllbbbbaaaacccckkkkOOOObbbbjjjjeeeecccctttt
  152.           callCallbacks()  className(), addCallback(),  removeCallback(),
  153.           removeAllCallbacks(), hasCallbacks(),  cloneCallbacks(),
  154.           cloneCallback()
  155.  
  156.  
  157. KKKKNNNNOOOOWWWWNNNN DDDDEEEERRRRIIIIVVVVEEEEDDDD CCCCLLLLAAAASSSSSSSSEEEESSSS
  158. VVVVIIIIEEEEWWWWKKKKIIIITTTT 2222....1111 CCCCHHHHAAAANNNNGGGGEEEESSSS
  159.    CCCCoooonnnnttttrrrroooollll FFFFuuuunnnnttttiiiioooonnnnssss
  160.            virtual VkSubProcess run(VkScreen *screen);
  161.  
  162.  
  163.           this additional API provides support for multi-screen
  164.           applications...
  165.  
  166. CCCCLLLLAAAASSSSSSSSEEEESSSS UUUUSSSSEEEEDDDD BBBBYYYY TTTTHHHHIIIISSSS CCCCLLLLAAAASSSSSSSS
  167.      VkSubProcess
  168.  
  169. BBBBUUUUGGGGSSSS
  170. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  171.      VkCallbackObject, VkSubProcess
  172.      _V_i_e_w_K_i_t _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e
  173.      _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m, DEC Press, Bob Sheifler and Jim Gettys
  174.      _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m _T_o_o_l_k_i_t, DEC Press, Paul Asente and Ralph Swick
  175.      _T_h_e _O_S_F/_M_o_t_i_f _P_r_o_g_r_a_m_m_e_r_s _R_e_f_e_r_e_n_c_e, Prentice Hall, OSF
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.